.Dd October 8, 2005
.Dt CFTP 1
.Os
.Sh NAME
.Nm cftp
.Nd Conch command-line SFTP client
.Sh SYNOPSIS
.Nm cftp
.Op Fl B Ar buffer_size
.Op Fl b Ar command_file
.Op Fl R Ar num_requests
.Op Fl s Ar subsystem
.Os
.Sh DESCRIPTION
.Nm cftp
is a client for logging into a remote machine and executing commands to send and receive file information. It can wrap a number of file transfer subsystems
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl B
Specifies the default size of the buffer to use for sending and receiving. (Default value: 32768 bytes.)
.It Fl b
File to read commands from, '-' for stdin. (Default value: interactive/stdin.)
.It Fl R
Number of requests to make before waiting for a reply.
.It Fl s
Subsystem/server program to connect to.
.El
.Pp
The following commands are recognised by
.Nm cftp :
.Bl -tag -width Ds
.It Ic cd Ar path
Change the remote directory to 'path'.
.It Ic chgrp Ar gid Ar path
Change the gid of 'path' to 'gid'.
.It Ic chmod Ar mode Ar path
Change mode of 'path' to 'mode'.
.It Ic chown Ar uid Ar path
Change uid of 'path' to 'uid'.
.It Ic exit
Disconnect from the server.
.It Ic get Ar remote-path Op Ar local-path
Get remote file and optionally store it at specified local path.
.It Ic help
Get a list of available commands.
.It Ic lcd Ar path
Change local directory to 'path'.
.It Ic lls Op Ar ls-options Op Ar path
Display local directory listing.
.It Ic lmkdir Ar path
Create local directory.
.It Ic ln Ar linkpath Ar targetpath
Symlink remote file.
.It Ic lpwd
Print the local working directory.
.It Ic ls Op Ar -l Op Ar path
Display remote directory listing.
.It Ic mkdir Ar path
Create remote directory.
.It Ic progress
Toggle progress bar.
.It Ic put Ar local-path Op Ar remote-path
Transfer local file to remote location
.It Ic pwd
Print the remote working directory.
.It Ic quit
Disconnect from the server.
.It Ic rename Ar oldpath Ar newpath
Rename remote file.
.It Ic rmdir Ar path
Remove remote directory.
.It Ic rm Ar path
Remove remote file.
.It Ic version
Print the SFTP version.
.It Ic ?
Synonym for 'help'.
.El
.Sh AUTHOR
cftp by Paul Swartz <z3p@twistedmatrix.com>. Man page by Mary Gardiner <mary@twistedmatrix.com>.
.Sh "REPORTING BUGS"
Report bugs to \fIhttp://twistedmatrix.com/trac/\fR
.Sh COPYRIGHT
Copyright \(co 2005-2008 Twisted Matrix Laboratories
.br 
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
